[1] 5.5
Aula 2
IFMG - Campus Formiga
25 de agosto de 2025
Tópicos
01-relatorio.qmd - Sistema de Publicação Quarto - Linguagem RDiretrizes para Aulas Mais Produtivas
🔊 Mantenha conversas em volume baixo
⌨️ Código com método:
95% dos erros são evitáveis com:
🤝 Inteligência colaborativa:
💪 Capacidade de Resolver Problemas
Cada erro resolvido é uma evolução da sua habilidade analítica
Um sistema de controle de versão
Um “sistema de salvamento inteligente” que registra cada versão dos seus documentos.
Armazena apenas as mudanças entre versões, economizando espaço.
Funciona como uma “máquina do tempo” para seu trabalho.
Facilita o trabalho em equipe sem conflitos graves.
Principais vantagens
Controle de Versões: Permite rastrear mudanças em seu código e suas alterações.
Recuperação de trabalho: Se algo der errado, você pode voltar facilmente a uma versão anterior que funcionava.
Evita a confusão de múltiplas versões: Adeus a arquivos como “Relatorio_Final_v2_Revisado_Corrigido.docx”.
Trabalho colaborativo organizado: Múltiplas pessoas podem trabalhar no mesmo projeto sem sobrescrever o trabalho umas das outras.
Documentação automática: O histórico de alterações serve como documentação da evolução do seu trabalho.
Padrão no mercado e na comunidade científica: Conhecimento valorizado e amplamente exigido.
Comandos Essenciais
Os quatro comandos básicos que você usará com mais frequência (seu fluxo de trabalho padrão no Terminal do RStudio) são:
git status: consulta o estado atual dos seus arquivosgit add: prepara as mudanças para serem salvasgit commit: salva as mudanças no repositório localgit push origin main: envia as mudanças para o GitHubPense nestes comandos como um processo de 4 passos:
status) -> arquivos e pastas em vermelho foram alterados/criados ou não estão sendo rastreados pelo Git.add).commit).push).Uma plataforma colaborativa baseada em Git
Figura 1: Fluxo de trabalho Básico
Sincronizando o repositório local com o GitHub
Vá até seu repositório no GitHub
Atualize a página do seu repositório no GitHub (F5)
Verifique se os arquivos foram enviados corretamente
Se tudo estiver correto, você verá a estrutura de pastas e arquivos que criou no RStudio
Descrição
Versionando o que é importante
Ignorando o que é regenerável
Para aprofundamento
Definição
É um sistema de publicação científica e técnica de código aberto que une texto narrativo e código para produzir documentos elegantemente formatados.
Com o Quarto, você pode criar diversos produtos:
Figura 2: Sistema Quarto: um formato, diversos produtos.
Figura 3: Funcionamento do Sistema Quarto com a linguagem R.
Definição
Quando você renderiza um arquivo Quarto (que possui a extensão .qmd) contendo código R, primeiro o pacote knitr da linguagem R executa todas as células de código R e cria um novo arquivo markdown (.md), que inclui o código e sua saída.
O arquivo markdown gerado é então processado pelo programa pandoc, que gera o formato escolhido.
O botão Render do Rstudio encapsula essas ações e as executa na ordem correta para você.
Integração com RStudio
No RStudio, você pode criar e editar arquivos Quarto facilmente:
Principais benefícios
Reprodutibilidade: Documenta todo o processo de análise de dados, garantindo que seu trabalho possa ser reproduzido.
Integração de código e narrativa: Combina texto explicativo, código e resultados em um único documento.
Múltiplos formatos de saída: Gera diferentes formatos (html, pdf, docs, apresentações) a partir do mesmo arquivo fonte.
Atualizações automáticas: Ao modificar dados ou código, basta renderizar o documento para atualizar todos os resultados.
Nota
Um arquivo Quarto (.qmd) consiste de três elementos fundamentais:
---
title: "Análise de Vendas"
author: "Seu Nome"
format:
html:
toc: true
theme: cosmo
execute:
echo: true
warning: false
---Atenção à indentação!
Código Markdown:
Tutorial completo
Acesse o tutorial sobre Markdown para mais detalhes.
Exemplo de célula de código R básica:
O resultado é:
[1] 5.5
Como inserir células de código quarto no RStudio?
Você pode adicionar uma célula de código de três maneiras:
Usando o atalho de teclado: Ctrl+Alt+I (Windows/Linux) ou Cmd+Option+I (Mac).
Clicando no ícone C “Insert a new code chunk” na barra superior de ferramentas do RStudio e selecionando “R”.
Digitando manualmente os delimitadores de célula: ```{r} e `````.
Exemplo de célula de código R com opções:
O resultado do código anterior é:
# A tibble: 3 × 3
cyl n mpg_média
<dbl> <int> <dbl>
1 4 11 26.7
2 6 7 19.7
3 8 14 15.1
# Gráfico de dispersão entre consumo (hwy) e potência (displ)
# cria um sistema de coordenadas e elementos estéticos básicos
ggplot(ggplot2::mpg, aes(x = displ, y = hwy)) +
# cria um gráfico de dispersão
geom_point() +
# aplica um tema minimalista
theme_minimal() +
# define títulos e rótulos dos eixos
labs(title = "Consumo de Combustível x Potência do Motor",
x = "Cilindrada do Motor",
y = "Milhas por Galão")| Opção | Descrição | Exemplo |
|---|---|---|
echo |
Mostrar o código? | #| echo: true |
eval |
Executar o código? | #| eval: true |
warning |
Mostrar avisos? | #| warning: false |
message |
Mostrar mensagens? | #| message: false |
label |
Identificador único para uma figura | #| label: fig-analise |
fig-cap |
Legenda da figura | #| fig-cap: "Gráfico de dispersão" |
Configuração global
Defina opções de código para todo o documento no YAML:
Vamos à prática!
Agora vamos ver um documento Quarto em ação no RStudio e uma pequena introdução à linguagem R.
01-relatorio.qmd
Tutorial e Guia de Consulta Rápida
Para informações detalhadas sobre o sistema Quarto, consulte o tutorial sobre Quarto
Autonomia na Resolução de Problemas
Os códigos são testados previamente - erros costumam ser de digitação ou por pular etapas.
Revise seu código com atenção antes de solicitar ajuda.
Colabore com colegas próximos para resolver questões técnicas simples.
Reserve as dúvidas ao professor para conceitos ou problemas mais complexos.
Ambiente de Aprendizado Colaborativo
Compartilhe conhecimento - explicar conceitos solidifica seu próprio entendimento.
Ao ajudar um colega, oriente sem resolver por ele.
Lembre-se: o progresso de cada um contribui para o aprendizado coletivo.
Desenvolvimento de Sofisticação Técnica
A habilidade de resolver problemas técnicos é valiosa em qualquer área de atuação.
“Aprenda a aprender” - invista tempo explorando além do que é apresentado em aula.
O objetivo não é apenas dominar ferramentas, mas desenvolver os pensamentos analítico e crítico.
Persista diante dos desafios - a resolução de erros é parte fundamental do processo de aprendizagem.
Documente suas descobertas para criar um repositório pessoal de conhecimento.